home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1997 / HAM Radio 1997.iso / vcls / wsanet8a / wsanet / readme.txt < prev    next >
Text File  |  1996-04-08  |  9KB  |  205 lines
  1.                               WSANet.VBX v1.08a
  2.                 Windows Sockets Networking Visual Basic Control
  3.  
  4.                              December 21, 1993
  5.  
  6.                              Author: Ian Blenke
  7.                         VB Suggestions: G. Michael Carr
  8.  
  9.               THIS IS AN ALPHA RELEASE. PLEASE KEEP DISTRIBUTIONS
  10.                          IN COMPETENT HANDS ONLY.
  11.  
  12.  
  13. Purpose:
  14.  
  15.     To encapsulate Windows Sockets v1.1 C calls and aid in
  16. quick network application development by adding an extention control to
  17. Visual Basic.
  18.  
  19.  
  20. Status:
  21.  
  22. -v1.00a:
  23. -    This is an alpha release. It is buggy. It will remain buggy until I
  24. -find the time and inclination to track them all down. Feel free to help
  25. -me in this venture, as it is likely to continue through to the release
  26. -version.
  27.  
  28. -v1.01a:
  29. -    Patch added to allow setting of LocalPort property. If set to 0,
  30. -an arbitrary port number will be assigned by your WinSock app.
  31. -    Now release 2 version of the VBX: WSMTPC.VBX and RELEASE.VBX. Both
  32. -are the same source code, but the RELEASE.VBX does not have debugging
  33. -information either in OutputDebugString() form or by compiler symbols.
  34. -In order to use this smaller "release" version, just rename WSNETC.VBX
  35. -to DBWSNETC.VBX (or equivalent) and copy RELEASE.VBX to WSNETC.VBX.
  36.  
  37. -v1.02a
  38. -    Internal minor overhaul of code
  39. -    Properties have changed "order", so this version will no longer work
  40. -with EXEs meant for previous versions.
  41. -    Not released due to bug fixes
  42.  
  43. -v1.03a
  44. -    Context sensitive help added
  45. -    Properties added: LocalService/RemoteService and SendThreshold
  46. -    OnSend() semantics have changed
  47. -    Added NetClientSendBlock() and NetClientRecvBlock() functions - BUT THEY
  48. - HAVEN'T BEEN TESTED YET.
  49. -    The Multiple events bug has been fixed - posting VBM_FIREEVENT messages
  50. - was a bad thing to do.
  51. -    Many minor bugs fixed.
  52.  
  53. -v1.04a
  54. -    Context sensitive completed. It's now awaiting criticism.
  55. -    OnTimeOut() semantics are now documented
  56. -    A Few dangerous bugs are now fixed
  57. -    VC++ should compile with fewer errors now, although the errors
  58.       "C:\WSNETC\WSNetC.H(3) : warning C4001: nonstandard extension used -
  59.        'single line comment'" and
  60.       "c:\wsnetc\init.c(26) : warning C4305: 'cast' : truncation from
  61.        'unsigned int __far *' to 'unsigned short '"
  62.      will persist until I find a #pragma or trick to silence them.
  63. -    VC++ Makefile added to the distribution (thanks Dan!)
  64. -    Possible problems with WinRSH still exist (like, it doesn't work)
  65.  
  66. -v1.05alpha
  67. -    Socket semantics have changed (although the ability to set it is not
  68.       yet technically implemented).
  69. -    New Toolbox BMP has been designed
  70. -    HLP updated: Changes topic added.
  71. -    The LocalPort property was broken previous to version 1.05alpha. Setting
  72.       it would set the RemotePort property.
  73. -    WSNETC.C and NETC.C now use the DEBUG_BUILD flag to mark debug/release
  74.       build versions (instead of keeping two copies of source).
  75. -    WSNETC.C cleaned up. Debugging information clearer now.
  76. -    NETC.C cleaned up. Debugging information clearer now.
  77. -    NET.C - Added "netConnect()" procedure to aid in the setting of the
  78.       Socket property
  79. -    All sources cleaned up for compilation by VC++ (uncomment USE_VC++ in
  80.       WSNetC.H)
  81. -    Fixed TimeOut bug. Previous versions will ALWAYS delay for just 1 second.
  82.  
  83. -v1.06alpha
  84. -    Added Version and Debug properties.
  85. -    Added HostAliasCount/HostAliasList() and
  86.       HostAddressCount/HostAddressList() properties
  87. -    Changed the HostAddr/HostName property code to avoid VB calls where
  88.       possible.
  89. -    Added Ini Control - 6 properties, no events
  90. -    Changed the names of EVERYTHING
  91. -    Moved everything around
  92. -    Caused general havok within the code:
  93.       Init.C is renamed to WSANet.C, and 2 procedures from WSNetC.C were
  94.        added.
  95.       WSNetC.C is copied over to NetClnt.C
  96.       Ini.C/Ini.H is added (to support the Ini control)
  97.       WSNetC.H becomes two files: NetClnt.H and WSANet.H
  98.       Functions added to Net.C: GetAtomHsz(), SetAtom()
  99.      Reason for changes:
  100.       NetClnt.C/NetClnt.H now hold all of the NetClient control code
  101.       Ini.C/Ini.H now hold all of the Ini control code
  102.       WSANet.C/WSANet.H is the "glue" for the project.
  103.       Version.H holds all version information
  104.       WSANet.RC/WSANet.DEF hold the resources and definitions
  105. -    Caused the programmer many headaches as he renamed everything ;)
  106. -    Wrote a new example client: WiNslookup
  107. -    Added 2 sample clients to the HLP file.
  108.  
  109. -v1.07alpha
  110. -    Added the NetServer control.
  111. -    Fixed a nasty problem with v1.06alpha's use of ATOMs to store strings:
  112.       all strings are now stored internally as Visual Basic strings (type
  113.       HLSTR).
  114. -    Changed the semantics of setting the Socket on the NetClient control so
  115.       that NetServer's OnAccept(Socket, ...) could be handed over.
  116. -    Fixed a potential problem with the FD_CLOSE message handler: it didn't
  117.       "zero out" the Socket when it closed!
  118. -    Dropped the VBTest client due to it's obvious inadequacies (and
  119.       pointlessness)
  120. -    Wrote WinWhois client.
  121. -    Wrote WFingerD server.
  122. -    Modified all VB3.0 examples to use a "standard" GUI appearance.
  123. -    Shuffled the HLP file around. Topics have changed to include the control
  124.       name along with the property context string.
  125.  
  126. -v1.08alpha (you are reading a pre-alpha version of this release)
  127. -    Fixed a problem that caused WSAE_NOCONN errors.
  128. -    Fixed a event firing problem.
  129. -    Fixed the connection semantics
  130. -    Added window position "memory" to VB3.0 samples
  131. -    Wrote VB-SMTPD server. Multiple incoming connections!
  132. -    Added LISTEN_DONTREUSE feature for the Listen property.
  133. -    Added the Host property
  134. -    Fixed a problem with the Line property (old versions can GPF randomly)
  135.  
  136. To-Do list:
  137.  
  138. - Make sure the binary transfer properties and functions are working
  139.     correctly (they are known to be broken).
  140. - Make VC++ "sample" applications (might be possible for me to do this
  141.     soon)
  142. - Add OnGetHost() event, and AsyncHandle property (for non-blocking DNS
  143.     lookups)
  144. - Add TCP/UDP and OOB switch.
  145.  
  146.  
  147. Requirements:
  148.  
  149. (Run time, Design time)
  150.     A TCP/IP stack with their WinSock.DLL v1.1
  151.     VB1.0+
  152.  
  153. (When recompiliing the control)
  154.     The CDK that comes with the professional versions of VB1.0/VB2.0/VB3.0 or
  155.      VC++
  156.     The only "extra" library needed is WINSOCK.LIB (which is provided).
  157.  
  158.  
  159. Copyright:
  160.  
  161. In this document, VBX refers to the actual Visual Basic control distributed
  162. with and based on this WSNETC project, and author refers to Ian Blenke. The
  163. author cannot be held responsible for damages, expressed or implied, for the
  164. use of this software. No commercial use can be made of this product without
  165. the consent of the author. No profit of any kind can be made on the sale or
  166. distribution of this program. If you wish to distribute this program with
  167. other samples of WinSock programming, you must first contact the author so
  168. that he can keep accurate records of its usage; no charge may be made for
  169. this project's availability other than the cost of the physical medium used
  170. to store it on and any processing costs. If you write any programs based on
  171. this source code, including parts of this source code, or in some way derived
  172. from this source code, you may not sell them for any profit without the
  173. written consent of the author. If you incorporate this VBX into a public
  174. domain program, all the author requires is a notification that "The NetClient
  175. control was written by Ian Blenke" and some form of notification that his name
  176. was used in the public domain software distribution. No profit of any kind,
  177. shareware/commercial or otherwise, may be made for software based on this VBX
  178. without the written consent of the author. This does not represent a contract
  179. on the part of the author. If any issues cannot clearly be resolved by reading
  180. this text, immediately contact the author.
  181.  
  182. The VBX control distributed with this project must be distributed with your
  183. programs free of charge. You cannot charge money for any program based on the
  184. VBX without the written consent of the author.
  185.  
  186. Notes:
  187.  
  188. If you have any bug reports and/or source patches... By all means, tell me! I
  189. would be glad to help keep this code up to date. Do not, however, modify this
  190. source in any way and re-distribute it without the author's knowledge. Follow
  191. the above Copyright, and all will be well.
  192.  
  193. I don't like such agreements, but in today's world of lawyers and lawbreakers,
  194. I have little other choice. Enjoy!
  195.  
  196. (This is meant to scare code "scalpers". Those that are actually learning C
  197.  programming for Visual Basic controls and WinSock applications are free to
  198.  adapt any of the ideas of this code. Remember, new code should be better
  199.  code, so "adapt" this, do NOT copy it.)
  200.  
  201.  
  202. Please consult the .HLP file for furthur information.
  203.  
  204.  
  205.